From: Daniel Boles <dboles@src.gnome.org>
Date: Mon, 12 Mar 2018 16:08:29 +0000 (+0000)
Subject: ListBox: Avoid ::row-activated/Row::activate ambig
X-Git-Tag: archive/raspbian/3.24.39-1+rpi1~1^2~65^2~37^2~10
X-Git-Url: https://dgit.raspbian.org/%22http://www.example.com/cgi/%22/%22http:/www.example.com/cgi/%22?a=commitdiff_plain;h=f08eeecae61452110115329906714de86675e53d;p=gtk%2B3.0.git

ListBox: Avoid ::row-activated/Row::activate ambig

…uity, by adding a doc comment to Row::activate explaining what it does
and why it is probably not what the user reading that is looking for.

https://bugzilla.gnome.org/show_bug.cgi?id=794008
---

diff --git a/gtk/gtklistbox.c b/gtk/gtklistbox.c
index 186fda861f..6fc931498a 100644
--- a/gtk/gtklistbox.c
+++ b/gtk/gtklistbox.c
@@ -3872,6 +3872,16 @@ gtk_list_box_row_class_init (GtkListBoxRowClass *klass)
 
   klass->activate = gtk_list_box_row_activate;
 
+  /**
+   * GtkListBoxRow::activate:
+   *
+   * This is a keybinding signal, which will cause this row to be activated.
+   *
+   * If you want to be notified when the user activates a row (by key or not),
+   * use the #GtkListBox::row-activated signal on the row’s parent #GtkListBox.
+   *
+   * Since: 3.10
+   */
   row_signals[ROW__ACTIVATE] =
     g_signal_new (I_("activate"),
                   G_OBJECT_CLASS_TYPE (object_class),